=====================================================================
                ZAPFLOW  —  MANUAL DE USO (LEIA-ME)
              Automação inteligente para WhatsApp Web
=====================================================================

    Feito com carinho pela SISTEMAS.STORE
    Site oficial: https://sistemas.store/zapflow
    Suporte / WhatsApp: https://sistemas.store/whats/?produto=ZapFlow&msg=Ol%C3%A1!%20Preciso%20de%20suporte%20para%20o%20ZapFlow.

        Versão da extensão: 2.3.7

---------------------------------------------------------------------
ÍNDICE
---------------------------------------------------------------------
  1. O que é o ZapFlow
  2. Requisitos
  3. Como instalar a extensão (download / carregamento)
  4. Como ativar a licença
  5. Como usar (funcionalidades)
     5.1 Sidebar (painel lateral)
     5.2 Dashboard (editor completo)
     5.3 Mensagens rápidas
     5.4 Áudios
     5.5 Mídias
5.6 Fluxos
      5.7 Gatilhos automáticos
      5.8 Modo Privado
      5.9 Backup (exportar/importar)
      5.10 Disparo em massa (novo)
      5.11 Agendamento de disparos (novo)
      5.12 Roteiros com espera de resposta (novo)
      5.13 Etapas / CRM (novo)
      5.14 Exportar contatos CSV / vCard (novo)
      5.15 Áudio → texto / transcrição (novo)
      5.16 Histórico de disparos e envios restantes (novo)
  6. Dúvidas frequentes (FAQ)
  7. Problemas comuns e correções
  8. Aviso legal e direitos autorais


=====================================================================
1. O QUE É O ZAPFLOW
=====================================================================
O ZapFlow é uma extensão para o Google Chrome que roda 100% DENTRO do
WhatsApp Web. Ele permite:
  - Enviar mensagens rápidas (texto pronto) com um clique;
  - Enviar áudios e mídias salvos;
  - Criar FLUXOS: sequências automáticas de texto, áudio e mídia,
    com intervalo (delay) entre cada envio;
  - Criar GATILHOS automáticos: quando um contato enviar determinada
    palavra-chave, o ZapFlow responde no chat certo, sozinho;
  - Usar o MODO PRIVADO para proteger sua tela e sua privacidade;
  - Fazer backup (exportar/importar) de toda a sua configuração.

Nada é instalado no seu computador além da extensão do navegador.
Todos os seus dados ficam salvos LOCALMENTE, no próprio navegador
(chrome.storage). Você é o dono dos seus dados.


=====================================================================
2. REQUISITOS
=====================================================================
  - Google Chrome (ou navegador baseado em Chromium) atualizado;
  - Acesso ao site https://web.whatsapp.com (WhatsApp Web);
  - Conexão com a internet;
  - Uma chave de licença válida (ZFP-XXXX-XXXX-XXXX-XXXX), comprada
    em https://sistemas.store/zapflow.


=====================================================================
3. COMO INSTALAR A EXTENSÃO (DOWNLOAD / CARREGAMENTO)
=====================================================================
Como esta é uma extensão comercial, ela é instalada em modo de
desenvolvedor (siga o passo a passo abaixo UMA vez):

  1) Baixe/descompacte a pasta da extensão ZapFlow no seu computador.
  2) Abra o Google Chrome e digite na barra de endereço:
        chrome://extensions
  3) Ative o interruptor "Modo do desenvolvedor"
     (canto superior direito).
  4) Clique no botão "Carregar sem compactação".
  5) Selecione a PASTA da extensão ZapFlow (a pasta que contém o
     arquivo manifest.json).
  6) A extensão aparecerá na lista. PRONTO!

Para RECARREGAR a extensão (após uma atualização):
  - Em chrome://extensions, clique no botão de atualizar (ícone de
    seta circular) no cartão do ZapFlow.
  - Depois, atualize (F5) a página do WhatsApp Web.

Dica: se o WhatsApp Web já estiver aberto, feche e abra novamente
após carregar a extensão, para garantir que tudo carregue.


=====================================================================
4. COMO ATIVAR A LICENÇA
=====================================================================
Ao abrir o WhatsApp Web, o ZapFlow mostra uma tela de ATIVAÇÃO:

  1) Digite sua chave de licença (formato: ZFP-XXXX-XXXX-XXXX-XXXX);
  2) Clique em "ATIVAR";
  3) Aguarde a mensagem "Licença ativada!".

O mesmo deve ser feito no Dashboard (editor), se solicitado.

Sobre o vencimento:
  - Ao lado do logo ZapFlow aparece um selo pequeno (ex.: "⏳ 27d 14h")
    mostrando quantos dias/horas faltam para a renovação.
  - Quando expirar, basta comprar/renovar em https://sistemas.store/zapflow
    e reativar com a nova chave.


=====================================================================
5. COMO USAR (FUNCIONALIDADES)
=====================================================================

---------------------------------------------------------------------
5.1 SIDEBAR (PAINEL LATERAL)
---------------------------------------------------------------------
O painel fica no lado direito do WhatsApp Web. No topo você encontra
as abas: Mensagens, Áudios, Mídias, Gatilhos, Fluxos e Privacidade.
No rodapé fica a marca SISTEMAS.STORE.

Você seleciona o contato/conversa no WhatsApp (clicando nele) e usa a
sidebar para enviar o que quiser para AQUELE chat.

---------------------------------------------------------------------
5.2 DASHBOARD (EDITOR COMPLETO)
---------------------------------------------------------------------
O Dashboard é a tela de gerenciamento completa. Para abri-lo:
  - Clique no logo "ZapFlow" na sidebar, OU
  - Clique no ícone do ZapFlow na barra do Chrome e selecione
    "Abrir editor" (Options/opções da extensão).

No Dashboard você edita tudo: Mensagens, Áudios, Mídias, Fluxos e
Gatilhos, além de exportar/importar backups.

---------------------------------------------------------------------
5.3 MENSAGENS RÁPIDAS
---------------------------------------------------------------------
  - Aba "Mensagens" da sidebar.
  - Clique em "+" para criar uma nova mensagem.
   - Escreva o texto. Você pode usar variáveis:
        {nome}     -> nome do contato
        {telefone} -> telefone do contato
        {saudacao} -> saudação conforme o horário
     (Aceita também com chave dupla: {{nome}}.)
  - Salve e, na conversa desejada, basta CLICAR na mensagem para
    enviá-la automaticamente.

---------------------------------------------------------------------
5.4 ÁUDIOS
---------------------------------------------------------------------
  - Aba "Áudios".
  - Clique em "+" e envie um arquivo de áudio (.ogg ou .mp3).
  - Clique no áudio salvo para enviá-lo como nota de voz no chat
    aberto. Opcional: marcar como "ver uma vez" (mensagem efêmera).

---------------------------------------------------------------------
5.5 MÍDIAS
---------------------------------------------------------------------
  - Aba "Mídias".
  - Clique em "+" e envie imagens, vídeos ou documentos.
  - Clique na mídia salva para enviá-la ao chat aberto.

---------------------------------------------------------------------
5.6 FLUXOS
---------------------------------------------------------------------
Fluxos são sequências automáticas de envio. Exemplo: enviar um texto,
esperar 6 segundos, enviar um áudio, esperar 8 segundos, enviar uma
mídia. Tudo na ordem que você definir.

  - No Dashboard, aba "Fluxos", clique em "+ Novo fluxo";
  - Dê um nome e monte a sequência de passos (texto/áudio/mídia),
    definindo o intervalo (delay) entre cada passo;
  - Salve. O fluxo fica disponível na sidebar, onde você pode
    "executar agora" (dispara no chat aberto).

Você também pode usar o CONSTRUTOR VISUAL (canvas) para montar o
fluxo arrastando e conectando nós na tela.

---------------------------------------------------------------------
5.7 GATILHOS AUTOMÁTICOS
---------------------------------------------------------------------
Gatilhos respondem automaticamente quando um contato envia uma
palavra-chave. A resposta é enviada SEMPRE no chat de origem (no
chat certo), evitando erro de conversa.

  - No Dashboard, aba "Gatilhos", crie um gatilho:
       Palavra-chave: ex.: "preço"
       Resposta: uma mensagem, áudio, mídia ou fluxo
  - ATIVE o interruptor geral "Gatilhos ativos" na sidebar/dashboard.

IMPORTANTE: o WhatsApp Web precisa estar aberto e logado para os
gatilhos funcionarem (tudo roda no navegador).

---------------------------------------------------------------------
5.8 MODO PRIVADO
---------------------------------------------------------------------
Aba "Privacidade" da sidebar. Permite (ligar/desligar):
  - Desfocar NOMES de contatos;
  - Desfocar FOTOS de contatos;
  - Desfocar mensagens recentes;
  - Desfocar mensagens da conversa;
  - Desfocar o campo de digitação;


Tudo é aplicado na hora. Ideal para quem trabalha em ambientes
compartilhados.

---------------------------------------------------------------------
5.9 BACKUP (EXPORTAR/IMPORTAR)
---------------------------------------------------------------------
  - No Dashboard: "Exportar" gera um arquivo .json com tudo: mensagens,
    áudios, mídias, fluxos, gatilhos, disparos, etapas/CRM, contatos das
    etapas, agendamentos e histórico de disparos.
  - "Importar" restaura um backup e substitui os dados atuais (inclusive
    disparos, etapas e agendamentos). Backups antigos, feitos antes desta
    atualização, não contêm os disparos/etapas.
  - IMPORTANTE: desinstalar a extensão apaga os dados do chrome.storage.local.
    Exporte o backup ANTES de remover/atualizar a extensão em outro perfil.
Guarde seus backups em local seguro.


---------------------------------------------------------------------
5.10 DISPARO EM MASSA
---------------------------------------------------------------------
Envie mensagens/áudios/mídias para VÁRIOS contatos de uma vez:

  1) No WhatsApp Web, abra a aba "⚡ Disparos" na sidebar ZapFlow
     (no lado direito, junto de Mensagens/Fluxos/Gatilhos);
     - O envio acontece SOMENTE aqui, no WhatsApp Web.
     - No Dashboard (editor) você monta e salva os disparos, mas NÃO
       consegue iniciar envios por ele.
  2) Clique em "Novo disparo";
  3) Escolha a ORIGEM dos contatos:
       - Todos os contatos (conversas @c.us);
       - Lista digitada / CSV (uma linha por contato: telefone;nome);
       - Participantes de grupos (mensagem privada para cada membro);
       - Postar NO grupo (envia no próprio grupo; marque "Mencionar
         todos em grupos (@all)" para marcar todo mundo);
       - Contatos de etapas (CRM);
       - Contatos de listas do WhatsApp Business (Lista WhatsApp Business);
  4) Monte o ROTEIRO (ordem de envio): texto, áudio, mídia, FLUXO
     salvo, espera e "aguardar resposta";
  5) Defina o intervalo entre contatos (fixo ou dinâmico, com mínimo
     de 2s para reduzir risco de bloqueio);
  6) Clique em "Salvar e iniciar".

Opcional: marque "Mencionar todos em grupos (@all)" para marcar todo
o grupo nas mensagens de texto (só funciona em conversas de grupo).

Variáveis no texto (nos disparos aceita chave simples OU dupla):
  {nome}  ou  {{nome}}      -> nome do contato
  {telefone} ou {{telefone}} -> telefone do contato
  {saudacao} ou {{saudacao}} -> Bom dia / Boa tarde / Boa noite

Durante o envio você vê o progresso por contato (enviado/erro) e pode
PAUSAR, RETOMAR ou PARAR a qualquer momento. Os erros podem ser
reenviados com o botão "↻ Erros". O progresso é salvo localmente, então
um disparo pausado/parado pode ser retomado depois.

Dica anti-bloqueio: use intervalo DINÂMICO (ex.: 8s a 20s) e evite
disparos muito longos em um único lote.


---------------------------------------------------------------------
5.11 AGENDAMENTO DE DISPAROS
---------------------------------------------------------------------
No editor do disparo, marque "Agendar para data/hora" e informe quando
o disparo deve começar. O ZapFlow aguarda a hora marcada (mesmo com o
WhatsApp Web aberto) e inicia o envio automaticamente. Os agendamentos
pendentes ficam na aba "Agendados", mostram quanto falta para começar
(ex.: "em 2h 15min") e quantos contatos faltam enviar, e podem ser
cancelados. Se o disparo estiver SEM ITENS ou sem origem de contatos na
hora marcada, o agendamento é cancelado com um aviso e fica registrado
no Histórico.


---------------------------------------------------------------------
5.12 ROTEIROS COM ESPERA DE RESPOSTA
---------------------------------------------------------------------
Ao montar o roteiro do disparo, adicione o item "Aguardar resposta".
O ZapFlow envia o que veio antes e ESPERA a pessoa responder antes de
continuar (ou até atingir o tempo máximo configurado). Ideal para
roteiros interativos de vendas e atendimento.


---------------------------------------------------------------------
5.13 ETAPAS / CRM
---------------------------------------------------------------------
Organize seus contatos em ETAPAS (ex.: Lead, Proposta, Fechado):
  1) Aba "⚡ Disparos" → "Etapas / CRM";
  2) Crie etapas e, na conversa aberta, clique em
     "➕ Adicionar conversa atual" (ou "🔍 Escolher contato");
  3) Use as etapas como origem de um disparo em massa ou de uma
     exportação de contatos.


---------------------------------------------------------------------
5.14 EXPORTAR CONTATOS (CSV / VCARD)
---------------------------------------------------------------------
Na aba "Exportar contatos" escolha a origem (todos, etapas, grupos,
listas ou lista digitada) e o formato: CSV (Telefone,Nome) ou
vCard (.vcf, compatível com celulares e apps de agenda). O arquivo é
baixado na hora.


---------------------------------------------------------------------
5.15 ÁUDIO → TEXTO (TRANSCRIÇÃO DE VOZ)
---------------------------------------------------------------------
Recurso OPCIONAL e DESLIGADO por padrão. Ele lê os áudios (mensagens de
voz) da conversa que estiver ABERTA e transforma em texto usando a Groq
(Whisper). O áudio e o texto passam apenas pelo navegador e pela API da
Groq; nada fica salvo em servidor do ZapFlow.

ONDE FICA
  - Botão redondo 🎙 no canto inferior direito do WhatsApp Web,
    acima da barra de atalhos do ZapFlow.
  - Verde = ativado. Cinza = desativado.

COMO CONFIGURAR (uma vez)
  1. Crie uma conta grátis em https://console.groq.com
  2. Menu "API Keys" (Chaves de API) → "Create API Key".
  3. Copie a chave (começa com gsk_...). Ela só aparece uma vez.
  4. No ZapFlow, clique no 🎙 → "Configurar agora".
  5. Cole a chave (uma por linha, pode colar várias) e marque
     "Ativar transcrição de áudio". Salve.
  - Várias chaves = mais limite. O ZapFlow troca de chave sozinho
    quando uma estoura o limite ou é inválida.

COMO USAR
  1. Abra a conversa que deseja ler (grupo ou individual).
  2. Clique no 🎙. O painel mostra o NOME DA CONVERSA aberta e a lista
     dos áudios recentes.
  3. Clique em "Transcrever" no áudio desejado, ou em
     "Transcrever todos" para a lista inteira.
  4. O texto aparece logo abaixo. Use "Copiar" para colar em qualquer
     lugar. No "×" você escolhe APAGAR a transcrição da tela e do cache
     (o áudio original no WhatsApp NÃO é apagado).

DICAS DE USO
  - Mantenha o WhatsApp Web aberto e a conversa certa aberta.
  - A lista mostra até 50 áudios recentes; role o chat para carregar
    áudios mais antigos e clique em ↻ (atualizar).
  - O resultado fica salvo em cache: reabrir o painel não gasta o
    seu limite de novo.
  - Áudio já apagado/expirado no WhatsApp aparece como indisponível.
  - Idioma padrão: português (pt). Pode mudar para "en", "es" etc.
  - No campo "Prompt" você pode listar nomes próprios, marcas e termos
    técnicos que costumam sair errados (melhora a precisão).

LIMITE GRATUITO (POR CHAVE)
  - Até 20 transcrições por minuto.
  - Até 2.000 transcrições por dia.
  - Até 120 minutos de áudio por hora.
  - Até 480 minutos (8 horas) de áudio por dia.
  - Arquivo máximo por áudio: 25 MB.
  Esses limites são contados a cada hora/dia; com 3 chaves, some os
  três. Exemplo prático: áudios de ~30s → cerca de 960 áudios por dia
  por chave.
  Observação: a Groq cobra um mínimo de 10 segundos por transcrição,
  então áudios muito curtos consomem como se tivessem 10s.

O QUE FAZER SE DER ERRO
  - "Sem chave": cole a chave e salve.
  - "Todas as chaves esgotadas": você atingiu o limite da Groq.
    Aguarde o tempo indicado (libera por hora) ou cadastre outra chave.
  - "chave inválida / 401": a chave foi digitada errada ou foi
    apagada no site da Groq. Crie outra.
  - "Tempo esgotado ao falar com o WhatsApp": recarregue o WhatsApp
    Web (F5) e tente de novo.


---------------------------------------------------------------------
5.16 HISTÓRICO DE DISPAROS E ENVIOS RESTANTES
---------------------------------------------------------------------
A aba "📜 Histórico" (dentro de "⚡ Disparos") mostra, em tempo real:

  - Quantos envios ainda FALTAM no total;
  - Quantos envios já foram concluídos;
  - Quantos disparos estão em andamento e quantos estão agendados;
  - Para cada disparo em andamento/agendado: enviados, total e
    "faltam X", além da data/hora e da contagem regressiva do
    agendamento (ex.: "em 35 min");
  - Lista dos últimos eventos (início, envio por contato, avisos,
    erros, pausa, retomada, conclusão, agendamento e cancelamento).

Os eventos são salvos localmente (últimos 500) e continuam lá mesmo se
você fechar o WhatsApp Web. Botões disponíveis:
  - "↻ Atualizar": recarrega os números na hora;
  - "⤓ Exportar": baixa um arquivo .txt com todo o histórico;
  - "🗑 Limpar": apaga o histórico (NÃO apaga o progresso dos disparos).

Se um disparo estiver "SEM ITENS" ou com origem vazia, o Histórico registra o
motivo do bloqueio — assim o cliente sabe exatamente por que o envio
não começou e quantos contatos ficaram pendentes.


=====================================================================
6. DÚVIDAS FREQUENTES (FAQ)
=====================================================================

P: Preciso instalar algum programa além da extensão?
R: Não. Apenas a extensão no Chrome. Tudo roda no navegador.

P: Preciso manter o WhatsApp Web aberto?
R: Sim. Como tudo roda no navegador, o WhatsApp Web precisa estar
   aberto e logado para os gatilhos e fluxos dispararem.

P: Onde ficam os meus dados?
R: 100% no seu navegador (chrome.storage.local). Você pode exportar
   para um arquivo .json quando quiser.

P: Posso usar a mesma chave em mais de um computador?
R: A licença é vinculada ao computador (HWID). Somente uma licença para um PC.
 Em caso de
   dúvida, chame o suporte.

P: O que fazer quando minha licença expirar?
R: A tela mostrará a mensagem de expiração. Renove em
   https://sistemas.store/zapflow e ative a nova chave.

P: O envio do gatilho pode ir para a conversa errada?
R: Não. O ZapFlow envia SEMPRE no chat de origem da mensagem.

P: A extensão funciona com WhatsApp Business?
R: Sim, desde que acessado via web.whatsapp.com.

P: Meus dados de mensagens/fluxos são compartilhados?
R: Não. Ficam apenas no seu navegador e são seus.

P: Como compro/reforço a licença?
R: Em https://sistemas.store/zapflow (pagamento via Pix, entrega
   imediata da chave) ou pelo WhatsApp de suporte.


=====================================================================
7. PROBLEMAS COMUNS E CORREÇÕES
=====================================================================

1) "A extensão não aparece / não carrega"
   - Verifique se você carregou a PASTA correta (com manifest.json).
   - Em chrome://extensions, veja se está ativo (ligado).
   - Feche e reabra o WhatsApp Web.
   - Atualize a extensão (botão de refresh em chrome://extensions)
     e dê F5 no WhatsApp Web.

2) "Failed to fetch / Erro ao validar licença"
   - Verifique sua conexão com a internet.
   - O site sistemas.store precisa estar acessível (liberado).
   - Confirme que digitou a chave corretamente (ZFP-...).
   - Aguarde alguns segundos e tente de novo.

3) "Tela bugada / conversa não renderiza ao clicar"
   - Na maioria das vezes é um travamento temporário do WhatsApp Web.
     Dê F5 (recarregar a página).
   - Se persistir, recarregue a extensão em chrome://extensions e
     recarregue o WhatsApp Web.

4) "Gatilho não responde"
   - Verifique se o interruptor "Gatilhos ativos" está LIGADO.
   - Confirme se o WhatsApp Web está aberto e logado.
   - Verifique se a palavra-chave digitada bate exatamente com a
     configurada.
   - Teste disparar o fluxo/gatilho manualmente na sidebar.

5) "Áudio/mídia não envia"
   - Confirme o formato suportado (áudio .ogg/.mp3; mídia imagem/
     vídeo/documento).
   - O WhatsApp Web precisa estar aberto e logado.
   - Tente recarregar a extensão e o WhatsApp Web.

6) "Sumiu minha configuração"
   - Recarregue a extensão (chrome://extensions -> refresh) e F5.
   - Se tinha feito backup, use "Importar" no Dashboard.

7) "Aparecem erros no console (F12)"
   - Muitos avisos vermelhos são INTERNOS do próprio WhatsApp Web e
     são inofensivos (ex.: "No available adapters", "QPL event").
   - Só se preocupe se o erro citar "ZapFlow"/"content_script".
     Nesse caso, recarregue a extensão e entre em contato com o
     suporte, relatando o texto do erro.

8) Ainda com problema?
   - Chame o suporte no WhatsApp: https://sistemas.store/whats/?produto=ZapFlow&msg=Ol%C3%A1!%20Preciso%20de%20suporte%20para%20o%20ZapFlow.
     Informe: versão da extensão, o que estava fazendo e, se possível,
     o texto do erro no console (F12).


=====================================================================
8. AVISO LEGAL E DIREITOS AUTORAIS
=====================================================================

  © 2026 SISTEMAS.STORE. Todos os direitos reservados.

  Este software ("ZapFlow") e todo o seu conteúdo (código-fonte,
  interface, textos, logotipos e documentação) são propriedade
  exclusiva da SISTEMAS.STORE e estão protegidos pelas leis de
  propriedade intelectual e direitos autorais do Brasil
  (Lei nº 9.610/1998) e tratados internacionais.

  É ESTRITAMENTE PROIBIDO:
    - Copiar, reproduzir, modificar, distribuir, vender ou ceder este
      software, no todo ou em parte, sem autorização escrita prévia;
    - Reverter a engenharia, descompilar ou tentar extrair o
      código-fonte ou o mecanismo de licenciamento;
    - Revender, sublocar ou compartilhar chaves de licença.

  LICENÇA DE USO:
    A compra da licença concede a VOCÊ o direito de USO PESSOAL e
    intransferível do software, em UMA instalação por chave, pelo
    período contratado. Não confere propriedade sobre o software.

  ISENÇÃO DE RESPONSABILIDADE:
    O ZapFlow é um software independente e NÃO é afiliado, endossado
    ou patrocinado pela Meta / WhatsApp. "WhatsApp", "WhatsApp Web"
    e "Meta" são marcas de seus respectivos proprietários. O uso da
    ferramenta é de responsabilidade do usuário, respeitando os
    Termos de Serviço da Meta e a legislação aplicável.

  SUPORTE E CONTATO:
    Site: https://sistemas.store/zapflow
    WhatsApp: https://sistemas.store/whats/?produto=ZapFlow&msg=Ol%C3%A1!%20Preciso%20de%20suporte%20para%20o%20ZapFlow.

---------------------------------------------------------------------
                 Obrigado por usar o ZapFlow!
                     SISTEMAS.STORE
---------------------------------------------------------------------